home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / gfx / show / FV21BETA-src.lha / FV21BETA-src / Readmefirst! < prev    next >
Text File  |  1997-08-25  |  9KB  |  289 lines
  1. Changes since the first BETA release:
  2.  
  3. - Small pictures will automatically be enlarged by a factor
  4.   of 2, 3 or 4 when shown on a large screen.
  5.  
  6. Troubleshooting:
  7.  
  8. * Monitor has to resync everytime FV shows a new picture.
  9.  
  10. This is because FV opens a new screen for the new picture in
  11. the background.  If the screen it has chosen has a different
  12. horizontal or vertical refresh rate then the monitor will
  13. have to resync which can be quite slow.  You can avoid this
  14. problem by only using screenmodes with the same horizontal
  15. and vertical refresh rates in the fvmodes file.  Personally
  16. I use only 2 screenmodes with FV, a 8 bit and a 16 bit one,
  17. both modes are the same size and have the same refresh
  18. rates.
  19.  
  20. ------------------------------------------------------------
  21.  
  22.  
  23. This is a BETA release of FV (formerly known as FastView).
  24.  
  25. Since AmiNet may face legal problems if I uploaded this
  26. program under the name FastView which now suddenly has been
  27. copyrighted by someone else, I've been forced to change the
  28. name of the program.  It will now simply be known as FV, but
  29. we all know what that stands for.
  30.  
  31. I've started from scratch with this version of FV, and it
  32. contains almost nothing from the old FastView 2.0 version
  33. which could be found on AmiNet just a few months ago (before
  34. it was removed for legal reasons).
  35.  
  36. ------------------------------------------------------------
  37.  
  38. This a very early BETA which at the moment just barely suits
  39. my own needs.  To avoid disappointment I will first tell you
  40. what this version of FV won't do (yet):
  41.  
  42.  - It won't work with OCS/ECS/AGA
  43.  
  44.  - It won't display IFF, BMP or PCX pictures
  45.  
  46.  - It doesn't have a filerequester and there is no
  47.    workbench support
  48.  
  49. I should also warn you that this version has not been tested
  50. on any other configs than my own (4000/060 with Kick 3.1 and
  51. CyberGraphX), but this version of FV has run fine on my
  52. machine for months now.
  53.  
  54. So what does it currently do?
  55.  
  56.  - Supports CyberGraphX, so it can display pictures in
  57.    hicolor and truecolor.
  58.  
  59.  - Displays JPEG pictures using the JPEG Codec by Christoph
  60.    Feck (get it from Aminet).
  61.  
  62.  - Supports most types of GIF pictures, including
  63.    progressive decoding of Interlaced GIFs.
  64.  
  65.  - Pictures are converted to 256 colors or grayscales if
  66.    necessary.
  67.  
  68.  - Autoscaling: If pictures are too big to open a screen
  69.    for then FV will try to scale down the pictures until a
  70.    screen can be opened.  If the picture is too small for
  71.    the screen it will be automatically enlarged by a factor
  72.    of 2, 3 or 4.
  73.  
  74.  - AmigaDOS patterns (wildcards) supported.
  75.  
  76.  - Pictures are loaded and decoded in the background to
  77.    speed up viewing multiple pictures; this can take quite
  78.    some memory especially with 24-bit pictures.
  79.  
  80.  - Pictures can be displayed in alphabetic and random order.
  81.  
  82.  - Customised information about the picture can be displayed
  83.    above the picture.
  84.  
  85.  - The function keys can be defined to perform actions on
  86.    the picture while viewing it.
  87.  
  88.  - A script file let's you customise what screenmodes FV
  89.    is allowed to choose from.
  90.  
  91. ------------------------------------------------------------
  92.  
  93. Command line arguments
  94.  
  95. (Following are the command line arguments which already work
  96. in this version):
  97.  
  98. FILES/M
  99.  
  100. Allows you to specify one or more files or patterns.
  101.  
  102.  
  103. ALL/S
  104.  
  105. Specify this if you want FV to scan directories recursively.
  106.  
  107.  
  108. ORDER/K
  109.  
  110. This allows you to change the order in which the pictures
  111. are displayed.
  112.  
  113.  "A" : sorts the files alphabetically by their filename
  114.  "P" : sorts the files alphabetically by their full pathname
  115.  "R" : random
  116.  
  117. The default is to display the pictures in the order they
  118. were entered on the commandline or, in the case of
  119. wildcards, in the order they were found in the directory.
  120. If you specify a string not beginning with one of the
  121. letters described above then this keyword will default to
  122. using the random order.
  123.  
  124. Note: Only the first letter is checked for this keyword, so
  125.       it is possible to specify things like
  126.       "ORDER=alphabetical" or "ORDER=random" to get the
  127.       desired results.
  128.  
  129.  
  130. INFO/K
  131.  
  132. This option displays information above the picture.  It
  133. allows you to specify a formatting string to customize the
  134. information.  If you specify 'INFO=""' then the default
  135. formatting string is used (see below).
  136.  
  137. To customize the information string you simply specify a
  138. string after the keyword.  The string can contain these
  139. special character sequences which will be automagically
  140. replaced:
  141.  
  142.  %N = the complete path plus the name of the picture
  143.  
  144.  %n = the name of the picture (without path)
  145.  
  146.  %x = the horizontal size of the picture in pixels (not
  147.       taking scaling into account)
  148.  
  149.  %y = the vertical size of the picture in pixels (not
  150.       taking scaling into account)
  151.  
  152.  %d = the depth of the picture on disk (not the depth
  153.       of the screen!)
  154.  
  155.  %c = the comment associated with the picture
  156.  
  157.  %% = gives you a single '%'-character
  158.  
  159. The default string looks like this: "%n (%xx%yx%d) %c"
  160. which for example could result into:
  161.  
  162.  "Test.jpg (640x480x24) this looks like a car, I think"
  163.  
  164. for a color JPEG picture named 'Test.jpg' of 640x480 pixels
  165. with a comment "this looks like a car, I think" :-)
  166.  
  167.  
  168. F1/K, F2/K, F3/K, F4/K, F5/K, F6/K, F7/K, F8/K, F9/K, F10/K
  169.  
  170. These options allow you to define a custom function for each
  171. of the function keys.  The specified function will be
  172. executed each time you press the corresponding function key.
  173. FV will advance to the next picture when the function has
  174. completed.
  175.  
  176. Examples (also see the INFO/K option for a description of
  177. the special '%' character sequences):
  178.  
  179.   F1="Copy %N PICS:Sorted/Cars/Lamborghini/"
  180.  
  181.   Pressing F1 will copy the picture to
  182.   PICS:Sorted/Cars/Lamborghini - %N is automatically
  183.   replaced by the full pathname of the picture.  Be warned
  184.   however that the C/Copy command simply replaces any
  185.   picture of the same name in the destination directory.
  186.  
  187.   F5="Rename %N :Trashcan/%n"
  188.  
  189.   F5 will 'move' the picture into the trashcan directory
  190.   on the same drive.  Note that %n is replaced by just the
  191.   name of the picture, without its path.  Note that unlike
  192.   C/Copy, C/Rename will fail when there is already a
  193.   picture of the same name in the destination directory.
  194.  
  195.   F10="Delete %N"
  196.  
  197.   F10 now simulates the behaviour of the Shift + Del
  198.   function of FV.
  199.  
  200.  
  201. LEAVEMEM/K/N
  202.  
  203. Specifies the amount of memory in kilobytes FV should
  204. leave free.  You can use this keyword to limit FV's
  205. use of memory for predecoding pictures.  It defaults
  206. to 4096 kB
  207.  
  208. ** Note for CyberGraphX users:
  209. Don't set this too low, or you won't be able to show
  210. large pictures with the largest screen possible.  I
  211. would recommend setting this value no lower than the
  212. amount of memory present on your graphics card.
  213.  
  214.  
  215. DEBUG/S
  216.  
  217. Use this when sending bugreports.  It will output some
  218. additional information which makes it easier for me to
  219. analyze the problem.
  220.  
  221.  
  222. All the other keywords don't work yet, and some of them
  223. may never work (and will be removed at a later date).
  224.  
  225. ------------------------------------------------------------
  226.  
  227. The fvmodes file
  228.  
  229. In this file you can specify what screenmodes FV should be
  230. allowed to choose from.  Every line not starting with a
  231. comment introducer ("*", ";") will be interpreted by FV.
  232. You're not allowed to put blank lines in this file (not yet
  233. anyway).  The last line of the file must read "#END".  Below
  234. is an example:
  235.  
  236. * Put your comments here!
  237.  NOMW=800 NOMH=600 DEPTH=8  DESCRIPTION="800x600 in 8 bit"
  238.  NOMW=800 NOMH=600 DEPTH=16 DESCRIPTION="800x600 in 16 bit"
  239. #END
  240.  
  241. Any line not starting with a comment introducer is
  242. interpreted using the following template:
  243.  
  244.  "NOMW/N,NOMH/N,DEPTH/N,DESCRIPTION"
  245.  
  246. NOMW/N and NOMH/N
  247.  
  248. These are used to specify the normal width and height of the
  249. screenmode you want to select.  This is the visible size of
  250. the screenmode (see the ScreenMode prefs program which came
  251. with Workbench).
  252.  
  253.  
  254. DEPTH/N
  255.  
  256. This is the number of bits per pixel or the number of
  257. bitplanes of the screenmode you want to select.
  258.  
  259.  
  260. DESCRIPTION
  261.  
  262. An optional description which isn't used at the moment.
  263.  
  264.  
  265. FV will interpret this list of screenmodes at the start of
  266. the program and warn you of any errors.  If FV couldn't find
  267. a suitable modeid for the screenmode you described it will
  268. warn you about this and output the line number were the
  269. problem is located.
  270.  
  271. ------------------------------------------------------------
  272.  
  273. That's about it for the moment for the 'documentation'.
  274.  
  275. If there are any problems feel free to contact me.
  276.  
  277. Don't forget to include a debug output (using the DEBUG
  278. switch) and some information about your Amiga (use
  279. ShowConfig for example).  If you want to mail me a (large)
  280. picture which helps identifying a problem then please use
  281. the john@globalxs.nl account.
  282.  
  283.         EMail    : john@globalxs.nl
  284.                    john.hendrikx@grafix.xs4all.nl
  285.  
  286.         Fido     : 2:286/407.8
  287.         AmigaNet : 39:153/201.8
  288.         NLA Net  : 14:101/200.8
  289.